package cl.tinet.trainee.tarea6b.ejb;

import java.util.ArrayList;

import javax.ejb.Remote;

import cl.tinet.trainee.tarea6b.exceptions.UsuarioException;
import cl.tinet.trainee.tarea6b.model.Usuario;

/**
 * Interfaz que define los metodos a implementar por la clase Bean.
 * 
 * @author Frmancil
 * 
 */
@Remote
public interface UsuarioBean {
    /**
     * Recibe un usuario creado desde la capa web y lo agrega a una coleccion
     * de objetos.
     * 
     * @param nuevoUsuario
     *            Es el objeto usuario que recibe el metodo y agrega a la base
     *            de datos.
     * @throws UsuarioException
     *             asd.
     */
    void agregarUsuario(Usuario nuevoUsuario) throws UsuarioException;

    /**
     * Recibe del bean un usuario y lo elimina de la coleccion de objetos.
     * 
     * @param usuarioAEliminar
     *            Es el objeto usuario que recibe el metodo, para buscarlo y
     *            eliminar a su par.
     * @throws UsuarioException
     *             Algo.
     */
    void borrarUsuario(Usuario usuarioAEliminar)
            throws UsuarioException;

    /**
     * Recibe del bean un usuario y lo actualiza en la coleccion de objetos.
     * 
     * @param usuarioAActualizar
     *            Es el objeto usuario que recibe el metodo, para buscarlo y
     *            actualizar sus datos.
     * @throws UsuarioException
     *             Algo.
     */
    void actualizarUsuario(Usuario usuarioAActualizar)
            throws UsuarioException;

    /**
     * Recibe del bean un usuario y lee sus atributos desde la coleccion de
     * objetos.
     * 
     * @param username
     *            Atributo para hacer busqueda de objeto.
     * @return Usuario encontrado es retornado para desplegar sus datos.
     */
    Usuario leerUsuario(String username);

    /**
     * Recibe del bean un String con el atributo username y lee sus atributos
     * desde la coleccion de objetos.
     * 
     * @param usuarioABuscar
     *            Objeto tipo usuario que se busca en la coleccion de objetos.
     * @return Usuario encontrado es retornado para desplegar sus datos.
     * @throws UsuarioException
     *             Algo.
     */
    Usuario buscarUsuario(Usuario usuarioABuscar)
            throws UsuarioException;

    /**
     * Metodo que retorna la lista de todos los usuarios.
     * 
     * @return Retorna una lista con todos los usuarios de la coleccion de
     *         objetos.
     */
    ArrayList<Usuario> listarUsuarios();
    /**
     * 
     * aa.
     *
     * @param datoUsuario a.
     * @return a.
     * @throws UsuarioException  a.
     */
    Usuario buscarUsuarioAgregado(Usuario datoUsuario) throws UsuarioException;

}